home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / pcbusu20.zip / PCBUSU.DOC < prev    next >
Text File  |  1992-01-01  |  8KB  |  185 lines
  1.  
  2.                           PCB User Search Utility
  3.                                  Ver. 2.0
  4.                      Copyright (C) 1991, 1992 By David Casto
  5.                                4560 Alps Court
  6.                              Gahanna, Ohio 43230
  7.                                (614) 337-2115
  8.  
  9.  
  10.  
  11.  WARNING!!
  12.       As with all new software it is *strongly* recommended that                                                                                                                                      you
  13.      have a recent backup just in case.
  14.  
  15.  Legal:
  16.       David Casto hereby disclaims all warranties relating to this
  17.      software, whether express or implied, including without
  18.      limitation any implied warranties of merchantability or fitness
  19.      for a particular purpose. David Casto will not be liable for any
  20.      special, incidental, consequential, indirect or similar damages
  21.      due to loss of data or any other reason, even if David Casto or an
  22.      agent of David Casto has been advised of the possibility of such
  23.      damages.  In no event shall David Casto liability for any damages
  24.      ever exceed the price paid for the license to use software,
  25.      regardless of the form of the claim.  The person using the
  26.      software bears all risk as to the quality and performance of the
  27.      software.
  28.  
  29.       You are free to distribute this software as long as there are no
  30.      modifications to any files or the software.
  31.  
  32.  Registration:
  33.       If you find PCBUSU easy, and convenient to use, a registration of
  34.      $5.00 would be appreciated.
  35.  
  36.       Registration includes:
  37.  
  38.        1) New updates to the software available for download from Blue
  39.           Light BBS.
  40.  
  41.        2) User support also available on Blue Light BBS.
  42.  
  43.        3) Your peace of mind knowing that you have done the right thing!
  44.  
  45.       (Blue Light BBS is located in Columbus, Ohio (614) 766-9708.)
  46.  
  47.  System Requirements:
  48.       PCboard v.14.5
  49.       DOWNLOAD.TXT 
  50.  
  51.  What Is It? :
  52.       PCBUSU is a utility to find out what files a user has downloaded.
  53.      It reads the Download.txt file and creates a data file to get it's 
  54.      information from (faster).  We use it to find out if a *problem* 
  55.      user has downloaded too many files and what they were.  It can send 
  56.      a report to the screen, file, or a printer.  PCBUSU even has command 
  57.      line switches for use in an event!  
  58.  
  59.  Setup:
  60.       Place PCBUSU.EXE in a directory and execute it from that directory.
  61.      To convert PCBoard's Download.txt file into PCBUSU's own data base
  62.      select  option one from the menu. PCBUSU will ask the path to 
  63.      PCBoard's Download.txt file.  Type in the path (example, if it's 
  64.      in the C:\PCB directory then that's what you need to type in) and 
  65.      the converting will start.  The conversion tests here on my Down-
  66.      load.txt file took about 3 to 4 minuets, but it has about 12,000
  67.      lines to process and was done on a 286/16 processor so your time
  68.      will be different.
  69.  
  70.  Manual Operation:
  71.       At this point the overall manual operation is self explanatory to
  72.       a SysOp so I'll not waste my time:-)
  73.  
  74.  Command Line Switches:
  75.       For use in an event I have added eight command line switches.  
  76.      The /U /D /M /T /FT /FM and /A switches route the information to 
  77.      a file PCBUSU.TXT in the current directory.  The /I switch reads the 
  78.      download.txt file and initializes / updates the PCBUSU.DAT file.  
  79.      You'll have to initialize each time BEFORE you run PCBUSU to get 
  80.      the latest file transfer activity from your system.  The initial-
  81.      ization process is slow with a large download.txt file so PCBUSU 
  82.      creates a DOWNLOAD.OLD file and appends the Download.txt information 
  83.      to it each time you initialize.  PCBUSU will then delete the 
  84.      Download.txt file, this will reduce the time for the initialize
  85.      process next time. PCBoard will start a new Download.txt when needed.
  86.      
  87.  
  88.       Example Command Lines:
  89.  
  90.         PCBUSU                    Loads PCBUSU for manual operation
  91.  
  92.         PCBUSU /IC:\PCB           Loads PCBUSU, initializes the data file
  93.                ^^^^^^^^           and exits back to DOS.
  94.            SwitchPath to DOWNLOAD.TXT
  95.  
  96.         PCBUSU /UDavid Casto      Loads PCBUSU, sends a report on David
  97.                ^^^^^^^^^^^^^      Casto's Uploads to PCBUSU.TXT and
  98.            SwitchUser Name        exits back to DOS.
  99.  
  100.         PCBUSU /DDavid Casto      Loads PCBUSU, sends a report on David
  101.                ^^^^^^^^^^^^^      Casto's Downloads to PCBUSU.TXT and
  102.            SwitchUser Name        exits back to DOS.
  103.  
  104.         PCBUSU /M12               Loads PCBUSU, sends a report on all
  105.                ^^^^               files to/from the system during Month
  106.            SwitchMonth            to PCBUSU.TXT and exits back to DOS.
  107.  
  108.         PCBUSU /T                 Loads PCBUSU, sends a report on all  
  109.                ^^                 files to/from the system for today
  110.            Switch                 to PCBUSU.TXT and exits back to DOS.
  111.        
  112.         PCBUSU /APcbUSU.zip       Loads PCBUSU, sends a report on all  
  113.                ^^^^^^^^^^^^       files to/from the system for FileName
  114.            SwitchFileName         to PCBUSU.TXT and exits back to DOS.
  115.         
  116.         PCBUSU /FTReg.zip         Loads PCBUSU, sends a report on FileName
  117.                ^^^^^^^^^^         to/from the system for today to PCBUSU.TXT
  118.             SwitchFileName        and exits back to DOS.
  119.        
  120.         PCBUSU /FM02Reg.zip       Loads PCBUSU, sends a report on FileName
  121.                ^^^^^^^^^^^^       to/from the system for Month to PCBUSU.TXT
  122.             SwitchMonthFileName   and exits back to DOS.
  123.        
  124.        
  125.        *NOTE: DO not put a backslash at the end of the path.  Also do
  126.         not put a space between the switch and the path and the switch
  127.         and user name etc.  Month has to be 2 characters (01, 12 etc.).
  128.  
  129.  *NOTE*: 
  130.       If you use a download counter that uses Download.txt: 
  131.         1) Run PCBUSU first 
  132.         2) Rename Download.OLD Download.TXT 
  133.         3) Run the download counter
  134.         4) Rename Download.TXT back to Download.OLD
  135.         
  136.         Example Event.bat:
  137.  
  138.            REM Run PCBUSU
  139.            C:
  140.            CD\PCBUSU
  141.            PCBUSU /IC:\PCB /DDavid Casto /FTReg.zip 
  142.            Rem Run Download Counter
  143.            C:
  144.            CD\PCB
  145.            REN DOWNLOAD.OLD DOWNLOAD.TXT     (Rename download.old to *.txt)
  146.            DLCOUNT DLCNT0.CFG                (Run Download counter) 
  147.            REN DOWNLOAD.TXT DOWNLOAD.OLD     (Rename download.txt to *.old)
  148.  
  149.  
  150.  
  151.  Misc. Info:
  152.       I have tested PCBUSU on a LANTASTIC AE2, a XT, 286, 386, 386 under
  153.      DesQview (3 Nodes) without a hitch.  PCBUSU opens the Download.txt
  154.      file in shared mode and should work while your Nodes are up and
  155.      running.  PCBUSU does NOT modify or change any PCBoard files it
  156.      only appends the Download.txt information to the Download.old
  157.      file!  Please forward any questions or sugestions to me at the phone
  158.      or address above.  I can also be reached on Blue Light BBS in Columbus,
  159.      Ohio at (614) 766-9708.
  160.  
  161.       I hope that this little utility helps, and thank you for trying
  162.      this software.
  163.  
  164.  
  165.  * NEW to Ver. 2.0:
  166.  
  167.        1) /M, /T, /A, /FT /FM switches.
  168.        2) Added UpLoad/DownLoad search for Today Menu Selection
  169.        3) Added UpLoad/DownLoad search for Month Menu Selection
  170.        4) Added FileName search for Month Menu Selection
  171.        5) Added FileName search for Today Menu Selection
  172.        6) Sped up the initialize process (You're welcome!)
  173.        7) Added ability to send more than one command line switch
  174.           at a time.
  175.        8) Reduced the PCBUSU.DAT file size.  PCBUSU.DAT files before
  176.           version 2.0 will not work.  Delete PCBUSU.DAT and rename
  177.           Download.old to Download.txt and re-initialize.
  178.        
  179.  
  180.  
  181.  
  182.  
  183.  
  184.        
  185.